### Game Status v1.2.0

Scroll down for the setup instructions.

<!-- ![Error 31-4302 when entering the door after login](LOGO-IF-E31-4302.jpg) -->
![Game is playable!](LOGO-IF-WORKING.jpg)


## Wanted

If you would like to help us, check the tasks on the [Issue tracker](https://notabug.org/Krock/GI-on-Linux/issues?labels=2024)

  * Some information might be missing from the Markdown files. Be sure to check the comments!

**Relevant:** [RE tools](TOOLS.md), [1.1.0 research journal](110/JOURNAL.md)


## Explanation

`mhyprot2.sys` is a kernel service which is and will not be supported by Wine. Problem: it's used as cheat detection.

**Possible solutions:**

 * Wine + patched game (what this project does)
 * Use a slow Windows VM or dual-boot
 * Wait for an official Linux build
 * Wait for kernel service support in Wine
 * Play another game. Format: link, caveats (Proton/Wine rating)
    * [Blue Protocol](https://www.hitc.com/en-gb/2020/10/02/blue-protocol-release-date/) unreleased, 2021/22 (N/A)
    * [Little Witch Nobeta](https://store.steampowered.com/app/1049890/Little_Witch_Nobeta/) singleplayer (Gold)
    * [Ashen](https://store.steampowered.com/app/649950/Ashen/) ~$40 (Platinum)
    * [Tower Hunter: Erza's Trial](https://store.steampowered.com/app/844850/Tower_Hunter_Erzas_Trial/) singleplayer (Platinum)
    * [Haven](https://www.gog.com/game/haven) PEGI 18 (N/A, too new)
    * [Valheim](https://store.steampowered.com/app/892970/Valheim/) unreleased, no story (Native)
    * [Pine](https://www.gog.com/game/pine) no story, singleplayer (Native)


## Project rules

 1. miHoYo reserves the right to distribute files. Please do not share any game data in public.
 2. For your own sake: **Do not share this project in official channels**.
    * Reduces the risk of this project to be taken down or used against our reverse-engineering efforts
    * Solution: Share the files required by the patch script (see `GAMEVER/README.txt`)
 3. Please do not abuse this project for cheating. We just want to play the game.

Beware that your log files may contain personal information, such as MAC addresses or login data.


#### Applying the workaround

Apply the patch(.sh) as follows. You will need Wine 5.3 or newer.

	# Download/clone the repository
	git clone https://notabug.org/Krock/GI-on-Linux --depth 1
	
	cd "/path/to/Genshin Impact Game"
	bash "/path/to/GI-on-Linux/GAMEVER/patch.sh"
	# Additional patch for 1.2.0
	bash "/path/to/GI-on-Linux/GAMEVER/patch_anti_logincrash.sh"
	
	# Please run "launcher.bat" to start the game
	wine cmd /c launcher.bat

Follow the script as instructed. Backups (.bak) are made automatically where needed.

Please **do not report any** game issues to an official channel. Your options are:

 * [Troubleshooting](TROUBLESHOOTING.md) page for common issues and solutions
 * Create a [new issue](https://notabug.org/Krock/GI-on-Linux/issues) here. See also: [closed/solved issues](https://notabug.org/Krock/GI-on-Linux/issues?state=closed&labels=2029)
 * Post your problem on a Wine/dxvk-specific page

**Undo:** The patch can be reverted using `patch_revert.sh` in the same manner.

**Chinese variant:** As of 1.2.0, not supported due to missing information. However, there is a prototype patch available.

## [Troubleshooting](TROUBLESHOOTING.md)

## [Credits](CREDITS.md)

License: MIT
